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Important notice 



Individual copies of the present document can be downloaded from: 
http://www.etsi.org 

The present document may be made available in more than one electronic version or in print. In any case of existing or 

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). 

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive 

within ETSI Secretariat. 

Users of the present document should be aware that the document may be subject to revision or change of status. 

Information on the current status of this and other ETSI documents is available at 

http://portal.etsi.org/tb/status/status.asp 

If you find errors in the present document, please send your comment to one of the following services: 

http://portal.etsi.org/chaircor/ETSI support.asp 

Copyright Notification 

No part may be reproduced except as authorized by written permission. 
The copyright and the foregoing restriction extend to reproduction in all media. 

© European Telecommunications Standards Institute 2005. 
All rights reserved. 

DECT™, PLUGTESTS™ and UMTS™ are Trade Marks of ETSI registered for the benefit of its Members. 
TIPHON™ and the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 
3GPP™ is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. 
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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under 
http ://webapp . etsi.org/kev/queryform. asp . 
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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.331 "Notification Log (NL) Integration Reference Point (IRP): Requirements". 

TS 32.332 "Notification Log (NL) (NL) Integration Reference Point (IRP): Information Service (IS)". 

TS 32.333 "Notification Log (NL) Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)". 

TS 32.334 "Notification Log (NL) Integration Reference Point (IRP): Common Management Information 

Protocol (CMIP) Solution Set (SS)". 

TS 32.335 "Notification Log (NL) Integration Reference Point (IRP): extensible Markup Language 

(XML) solution definitions". 

The present document is part of a set of Technical Specifications, which describes the requirements and information 
model necessary for Telecommunications Management (TM). The TM principles and TM architecture are specified in 
3GPP TS 32.101 [1] and 3GPP TS 32.102 [2]. 

A communications system is composed of a multitude of Network Elements (NE) of various types and, typically, 
different vendors, which inter-operate in a coordinated manner in order to satisfy the network users' communication 
requirements. 

The occurrence of faults in an NE may cause deterioration or loss of this NE's function. Fault Management is the 
functional area, which allows the operator to detect the occurrence of faults in the network in real-time. Configuration 
Management and Performance Management are two more functional areas, which require the operator to be alerted to 
certain conditions in the network. 

A standard general-purpose mechanism for the management of logs containing selected notifications from the network 
is required to provide an ability to perform historical analysis on faults and conditions, which occurred in the network. 
The documents series 32.33x, constituting the Notification Log IRP, sets forth such a mechanism - and the present 
document contains the relevant XML definition. 
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Scope 



The present document specifies the XML Definitions for the Notification Log Integration Reference Point (NL IRP) as 
it applies to Itf-N, in accordance with Notification Log IRP requirements and IS definitions [3], [4]. 

This XML Definitions specification defines the XML syntax of the NL IRP XML Data File. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.331: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Requirements". 

[4] 3GPP TS 32.332: "Telecommunication management; Notification Log (NL) Integration Reference 

Point (IRP): Information Service (IS)". 

[5] 3GPP TS 32.342: "Telecommunication management; File Transfer (FT) Integration Reference 

Point (IRP); Information Service (IS)". 

[6] 3GPP TS 32.305: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): extensible Markup Language (XML) definitions". 

[7] 3GPP TS 32.1 1 1-5: "Telecommunication management; Fault Management; Part 5: Alarm 

Integration Reference Point (IRP): extensible Markup Language (XML) definitions". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
and 3GPP TS 32.331 [3] apply. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

IRP Integration Reference Point 

IS Information Service 

NL Notification Log 

UML Unified Modelling Language 

IRP Integration Reference Point 
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NRM 
XML 



Network Resource Model 
extensible Markup Language 



4 Structure and content of NL IRP XML 

The present clause defines the XML exchanged between an IRPManager and an IRP Agent as part of NL IRP IS (see 
[4]): 

• the NL IRP XML Data File, 

• NL IRP notifications. 

The use of XML schemas ensures NL XML have the proper structure and to some extent the proper content, and in 
particular to ensure: 

for a given Notification instance, it is properly named/positioned with regard to the global naming tree; 

for a given Notification instance, only attributes of the corresponding Notification are present; 

for a given Notification attribute, its value is of the proper type. 

XML definitions for other application specific notifications (e.g. Alarm IRP notifications, Notification IRP Notification 
Header) are defined within the respective IRP series within specification 32.xy5. 



4.1 



Global structure 



Editor's Note: To be added in future version of this specification. 

4.2 XML elements fileHeader and fileFooter 

Editor's Note: To be added in future version of this specification. 

4.3 NL IRP XML File Name Conventions 

For NL IRP XML File Name Conventions the generic file name definitions as specified by the FT IRP apply (see [5]). 

4.4 NL Interface IRP-specific XML schemas 

Interface IRP-specific XML schemas with definition of corresponding XML namespace prefixes are listed by the 
following table: 

Table 4.4: Interface IRP-specific XML schemas, corresponding 3GPP TSs and XML namespace 

prefixes 



IRP 


XML schema 


3GPP TS no. 


XML namespace prefix 


Alarm IRP 


alarmlRPnotif . xsd 


32.111-5 [7] 


xa 


Notification IRP 


notification .xsd 


32.305 [6] 


xe 


Notification Log IRP 


notificationLog.xsd 


32.335 


xl 



Each Interface IRP-specific XML schema explicitly declares Interface IRP-specific XML element types for the related 
Interface IRP. 
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Additionally, XML schema notification . xsd (see [06]) also provides global XML declarations and definitions 
for the support of: 

Notification header XML element type declaration 



4.5 



NL IRP XML File Content Definitions 



4.5.1 NL IRP XML Data File 

The structure of the Notification Log IRP XML Data File is shown in graphical depiction below: 
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Figure 4.5.1 : Structure of the Notification Log IRP XML Data File 

The notificationLogRecords element holds the instances of the notification records that are imported from the 
Notification Format XML schema. Note that Notification Header XML definitions are provided in [6]. 

The Notification Log IRP XML Data File is a simple instance based construct. The XML schema for the Notification 
Log IRP XML Data File is defined in Annex A. 

4.6 NL IRP Notification XML Definitions 

This section provides XML definitions of Notification Log IRP notifications as defined in [4]. 
Editor's Note: To be added at a later stage. 
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Annex A (normative): 

Configuration data file base XML schema 

(file name "notificationLog.xsd") 

<?xml version=" 1 . " encoding="UTF-8"?> 
<! — 

3GPP TS 32.335 Notification Log IRP 

The 3GPP Notification Log IRP XML Solution Definition, Schema Definition 
notificationLog.xsd 
— > 

< schema 

targetNamespace="http: //www. 3gpp. org/ftp/specs/latest/rel-6/32_series/32335#notifLog" 

element FormDefault=" qualified" 

at tributeFormDefault=" unqualified" 

xmlns="http: //www. w3 . org/200 1/XMLSchema" 



xmlns : xs="http 
xmlns : xe="http 
xmlns : xa="http 
> 



//www. w3.org/2001/XMLSchema" 

//www. 3gpp. org/ftp/specs/latest/rel-6/32_series/32305#notif i cat ion" 

//www. 3gpp. org/ftp/specs/latest/rel-6/32_series/32111-5#alarmIRPNotif " 



< import name space ="http : //www. 3gpp . org/ ftp/ specs /latest /rel-6/32_series/32305#notif i cat ion" /> 
< import namespace="http : //www. 3gpp . org/ ftp/ specs/ latest /rel- 6/ 32_series/ 3211 l-5#alarmIRPNot if " /> 

<element name="notif icationLog"> 
<complexType> 
<all> 

<element name="notif icationLogHeader "> 
<complexType> 
<all> 

<element name="logFileVersion"/> 
<element name="vendorName"/> 
<element name="senderName"/> 
</all> 
</complexType> 
</element> 

<element name="notif icationLogRecords" minOccurs="0"> 
<complexType> 

<sequence minOccurs="0" maxOccurs="unbounded"> 
<element name="notif cationLogRecord"> 
<complexType> 
<sequence> 

<element name="logRecordId" type="xs : string"/> 
<element ref="xe : Not if ication"/> 
</sequence> 
</complexType> 
</element> 
</sequence> 
</complexType> 
</element> 
</all> 
</complexType> 
</element> 
</schema> 
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Annex B (informative): 

NL IRP XML Example Notification 



This annex provides an XML example notification, demonstrating the use of and the embedding into the NL IRP XML 
Notification Format. This example makes use of the Alarm IRP XML Schema for Notification. 

<?xml version=" 1 . " encoding="UTF-8 " ?> 

<! — Sample XML file generated by XMLSPY v2004 rel. 4 U (http://www.xmlspy.com) — > 

<notif icationLog xmlns="http: //www. 3gpp. org/ ftp/ specs /latest /rel-6/32_series/32335-600 . zip#notif Log" 
xmlns : xa="http: //www. 3gpp. org/ ftp/ specs /latest /rel-6/32_series/32 11 1-5-600 . zip#alarmIRPNotif " 
xmlns : xe="http : //www. 3gpp . org/ftp/specs/latest /rel-6/32_series/323 05-600 . zip#notification" 
xmlns : xsi = "http: //www. w3 . org/200 1 /XMLS enema- instance" > 
<notif icationLogHeader> 

<logFileVersion>Text</logFileVersion> 
<vendorName>Text</vendorName> 
<senderName>Text</senderName> 
</notif icationLogHeader> 
<notif icationLogRecords> 
<notif icationLogRecord> 

<logRecordId>100K/logRecordId> 
<xa : Notif yNewAlarm> 
<xe : header> 

<xe:objectClass>String</xe:objectClass> 
<xe:objectInstance>String</xe: object Instance> 
<xe:notificationID>21474 83 647</xe:notificationID> 
<xe:eventTime>2001-12-17T0 9: 30: 47-05 :00</xe:eventTime> 
<xe : systemDN>String</xe : systemDN> 

<xe : notif icationType>String</xe : notif icationType> 
</xe :header> 
<xa:body> 

<xa : probableCause>INDETERMINATE</xa : probableCause> 
<xa :perceivedSeverity>Indeterminate</xa : perceivedSeverity> 
<xa : alarmType>Communications Alarm</xa : alarmType> 
<xa : alarmID>l</xa : alarmID> 
</xa:body> 
</xa : Notif yNewAlarm> 
</notif icationLogRecord> 
</notif icationLogRecords> 
</notif icationLog> 
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Annex C (informative): 

NL IRP XML schema electronic files 

The electronic files corresponding to the normative XML schemas defined in the present document are available in 
native form in the following archive: 

http://www.3gpp.org/ftp/specs/archive/32_series/32.335/schema/326335-600-XMLSchema.zip 
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Annex D (informative): 
Change history 
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